@agent-native/core 0.48.3 → 0.49.0

package/dist/agent/context-xray/actions/context-evict.d.ts

@@ -3,7 +3,7 @@ declare const _default: import("../../../action.js").ActionDefinition<{
     segmentId: string;
 }, {
     directive: import("../../../shared/context-xray.js").ContextDirective;
-    manifest: import("../../../shared/context-xray.js").ContextManifest | null;
+    manifest: import("../../../shared/context-xray.js").ContextManifest;
 }>;
 export default _default;
 //# sourceMappingURL=context-evict.d.ts.map

package/dist/agent/context-xray/actions/context-pin.d.ts

@@ -3,7 +3,7 @@ declare const _default: import("../../../action.js").ActionDefinition<{
     segmentId: string;
 }, {
     directive: import("../../../shared/context-xray.js").ContextDirective;
-    manifest: import("../../../shared/context-xray.js").ContextManifest | null;
+    manifest: import("../../../shared/context-xray.js").ContextManifest;
 }>;
 export default _default;
 //# sourceMappingURL=context-pin.d.ts.map

package/dist/agent/context-xray/actions/context-report.d.ts

@@ -1,14 +1,14 @@
 import { type ContextManifest } from "../../../shared/context-xray.js";
 declare const _default: import("../../../action.js").ActionDefinition<{
     threadId: string;
-    model?: string | undefined;
+    model?: string;
     segments?: {
         segmentId: string;
         label: string;
         tokenCount: number;
-        group?: string | undefined;
-        status?: "active" | "pinned" | "evicted" | "summarized" | undefined;
-    }[] | undefined;
+        group?: string;
+        status?: "active" | "pinned" | "evicted" | "summarized";
+    }[];
 }, ContextManifest>;
 export default _default;
 //# sourceMappingURL=context-report.d.ts.map

package/dist/agent/context-xray/actions/context-restore.d.ts

@@ -3,7 +3,7 @@ declare const _default: import("../../../action.js").ActionDefinition<{
     segmentId: string;
 }, {
     restored: number;
-    manifest: import("../../../shared/context-xray.js").ContextManifest | null;
+    manifest: import("../../../shared/context-xray.js").ContextManifest;
 }>;
 export default _default;
 //# sourceMappingURL=context-restore.d.ts.map

package/dist/application-state/handlers.d.ts

@@ -1,4 +1,4 @@
-export declare const getState: import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<Record<string, unknown> | null>>;
+export declare const getState: import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<Record<string, unknown>>>;
 export declare const putState: import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<any>>;
 export declare const deleteState: import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
     ok: boolean;
@@ -6,7 +6,7 @@ export declare const deleteState: import("h3").EventHandlerWithFetch<import("h3"
 /** List all compose drafts */
 export declare const listComposeDrafts: import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<Record<string, unknown>[]>>;
 /** Get a single compose draft */
-export declare const getComposeDraft: import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<Record<string, unknown> | null>>;
+export declare const getComposeDraft: import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<Record<string, unknown>>>;
 /** Create or update a compose draft */
 export declare const putComposeDraft: import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<any>>;
 /** Delete a single compose draft */

package/dist/application-state/handlers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/application-state/handlers.ts"],"names":[],"mappings":"AAuCA,eAAO,MAAM,QAAQ,+GAKnB,CAAC;AAEH,eAAO,MAAM,QAAQ,oFAOnB,CAAC;AAEH,eAAO,MAAM,WAAW;;GAMtB,CAAC;AAQH,8BAA8B;AAC9B,eAAO,MAAM,iBAAiB,0GAI5B,CAAC;AAEH,iCAAiC;AACjC,eAAO,MAAM,eAAe,+GAK1B,CAAC;AAEH,uCAAuC;AACvC,eAAO,MAAM,eAAe,oFAe1B,CAAC;AAEH,oCAAoC;AACpC,eAAO,MAAM,kBAAkB;;GAM7B,CAAC;AAEH,gCAAgC;AAChC,eAAO,MAAM,sBAAsB;;GAOlC,CAAC"}
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/application-state/handlers.ts"],"names":[],"mappings":"AAuCA,eAAO,MAAM,QAAQ,wGAKnB,CAAC;AAEH,eAAO,MAAM,QAAQ,oFAOnB,CAAC;AAEH,eAAO,MAAM,WAAW;;GAMtB,CAAC;AAQH,8BAA8B;AAC9B,eAAO,MAAM,iBAAiB,0GAI5B,CAAC;AAEH,iCAAiC;AACjC,eAAO,MAAM,eAAe,wGAK1B,CAAC;AAEH,uCAAuC;AACvC,eAAO,MAAM,eAAe,oFAe1B,CAAC;AAEH,oCAAoC;AACpC,eAAO,MAAM,kBAAkB;;GAM7B,CAAC;AAEH,gCAAgC;AAChC,eAAO,MAAM,sBAAsB;;GAOlC,CAAC"}

package/dist/cli/app-skill.d.ts

@@ -0,0 +1,157 @@
+/**
+ * `agent-native app-skill` packages an agent-native app as a distributable
+ * skill bundle: instructions + MCP connector + embeddable app surfaces.
+ *
+ * The manifest intentionally contains no user secrets. Hosted installs write
+ * URL-only MCP entries; clients that need auth complete OAuth/device setup in
+ * the host. Local installs point at a developer-owned app process.
+ */
+import { type ClientId } from "./mcp-config-writers.js";
+export type SkillVisibility = "internal" | "exported" | "both";
+export type AppSkillHostAdapter = "codex-plugin" | "claude-marketplace" | "vercel-skills" | "plain-skill" | "claude-skill" | "chatgpt-mcp" | "generic-mcp";
+export interface AppSkillManifestSkill {
+    path: string;
+    visibility: SkillVisibility;
+    exportAs?: string;
+}
+export interface AppSkillSurface {
+    id: string;
+    action?: string;
+    path: string;
+    mediaTypes?: string[];
+    defaultMediaType?: string;
+}
+export interface AppSkillManifest {
+    schemaVersion: 1;
+    id: string;
+    displayName: string;
+    description: string;
+    /**
+     * Optional semver base for generated plugin manifests. Codex keys its plugin
+     * cache on the version string, so the packer appends a content hash to this
+     * base; leave it unset to default to "1.0.0".
+     */
+    version?: string;
+    hosted: {
+        url: string;
+        mcpUrl: string;
+    };
+    mcp: {
+        serverName: string;
+        aliases?: string[];
+    };
+    local?: {
+        template?: string;
+        sourcePath?: string;
+        defaultUrl?: string;
+        commands?: {
+            install?: string;
+            dev?: string;
+            start?: string;
+        };
+    };
+    auth?: {
+        mode?: "oauth" | "device" | "none";
+        setup?: string;
+    };
+    surfaces: AppSkillSurface[];
+    skills: AppSkillManifestSkill[];
+    hostAdapters: AppSkillHostAdapter[];
+}
+export interface LoadedAppSkillManifest {
+    manifest: AppSkillManifest;
+    file: string;
+    dir: string;
+}
+export interface ParsedAppSkillArgs {
+    command: "ensure" | "launch" | "pack" | "help";
+    manifest?: string;
+    client: string;
+    scope: string;
+    serverName?: string;
+    out?: string;
+    into?: string;
+    mode: "hosted" | "local";
+    dryRun: boolean;
+    skipInstall: boolean;
+    noRegister: boolean;
+    printJson: boolean;
+    yes: boolean;
+}
+export interface EnsureAppSkillOptions {
+    mode?: "hosted" | "local";
+    clients?: ClientId[];
+    scope?: string;
+    serverName?: string;
+    baseDir?: string;
+    dryRun?: boolean;
+    confirm?: boolean;
+    yes?: boolean;
+    log?: (message: string) => void;
+}
+export interface EnsureAppSkillResult {
+    mode: "hosted" | "local";
+    serverName: string;
+    mcpUrl: string;
+    clients: ClientId[];
+    written: {
+        client: ClientId;
+        file: string;
+    }[];
+}
+export interface LaunchAppSkillOptions {
+    mode?: "hosted" | "local";
+    into?: string;
+    dryRun?: boolean;
+    skipInstall?: boolean;
+    noRegister?: boolean;
+    clients?: ClientId[];
+    scope?: string;
+    serverName?: string;
+    baseDir?: string;
+    confirm?: boolean;
+    yes?: boolean;
+    log?: (message: string) => void;
+}
+export interface AppSkillLaunchPlan {
+    mode: "hosted" | "local";
+    appId: string;
+    appDir?: string;
+    sourceDir?: string;
+    url: string;
+    mcpUrl: string;
+    serverName: string;
+    commands: {
+        install?: string;
+        dev?: string;
+        start?: string;
+    };
+}
+export declare function normalizeAppSkillManifest(raw: unknown): AppSkillManifest;
+export declare function findAppSkillManifest(startDir?: string): string;
+export declare function loadAppSkillManifest(file?: string): LoadedAppSkillManifest;
+export declare function exportedSkills(manifest: AppSkillManifest): AppSkillManifestSkill[];
+export declare function internalSkills(manifest: AppSkillManifest): AppSkillManifestSkill[];
+export declare function parseAppSkillArgs(argv: string[]): ParsedAppSkillArgs;
+export declare function exportedSkillContentHash(manifestDir: string, skills: AppSkillManifestSkill[], manifest: AppSkillManifest): string;
+/**
+ * Plugin version embeds a content hash of the exported skills + MCP server
+ * identity/endpoint.
+ * Codex keys its plugin cache on the version string, so a changed skill or MCP
+ * URL yields a new version and `codex plugin marketplace upgrade` (which runs
+ * on startup) delivers the update automatically — no manual semver bump per
+ * edit. Claude Code uses commit-SHA versioning instead (plugin.json omits
+ * version), so it auto-updates on every push.
+ */
+export declare function resolvePluginVersion(manifest: AppSkillManifest, manifestDir: string, skills: AppSkillManifestSkill[]): string;
+export interface AppSkillPackResult {
+    outDir: string;
+    exportedSkillNames: string[];
+    files: string[];
+}
+export declare function buildAppSkillPack(loaded: LoadedAppSkillManifest, outDir: string): AppSkillPackResult;
+export declare function resolveLaunchPlan(loaded: LoadedAppSkillManifest, options?: LaunchAppSkillOptions): AppSkillLaunchPlan;
+export declare function ensureAppSkill(loaded: LoadedAppSkillManifest, options?: EnsureAppSkillOptions): Promise<EnsureAppSkillResult>;
+export declare function launchAppSkill(loaded: LoadedAppSkillManifest, options?: LaunchAppSkillOptions): Promise<AppSkillLaunchPlan>;
+export declare function runAppSkill(argv: string[]): Promise<void>;
+//# sourceMappingURL=app-skill.d.ts.map

package/dist/cli/app-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-skill.d.ts","sourceRoot":"","sources":["../../src/cli/app-skill.ts"],"names":[],"mappings":"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"}

package/dist/cli/app-skill.js

@@ -11,7 +11,7 @@ import os from "node:os";
 import path from "node:path";
 import { spawn } from "node:child_process";
 import { createHash } from "node:crypto";
-import { buildHttpMcpEntry } from "./mcp-config-writers.js";
+import { buildHttpMcpEntry, removeSameUrlDuplicatesForClient, } from "./mcp-config-writers.js";
 import { resolveClients, writeConfigs } from "./connect.js";
 const HELP = `agent-native app-skill
 
@@ -877,13 +877,23 @@ export async function ensureAppSkill(loaded, options = {}) {
     if (options.confirm && !options.yes) {
         await confirmMcpRegistration(result, loaded.manifest.displayName, scope);
     }
-    result.written = writeConfigs(clients, serverName, plan.mcpUrl, undefined, scope, options.baseDir ?? process.cwd());
-    if (!options.serverName) {
-        for (const alias of manifest.mcp.aliases ?? []) {
-            result.written.push(...writeConfigs(clients, alias, plan.mcpUrl, undefined, scope, options.baseDir ?? process.cwd()));
-        }
+    const baseDir = options.baseDir ?? process.cwd();
+    result.written = writeConfigs(clients, serverName, plan.mcpUrl, undefined, scope, baseDir);
+    // Aliases are intentionally NOT written as separate entries. Instead,
+    // repurpose the alias list as a cleanup list: remove any other entries in
+    // the same config files that point at the same URL (covers legacy alias
+    // names, old default names like 'agent-native-<slug>', and any stale
+    // custom names left from previous installs).
+    const allRemovedNames = [];
+    for (const client of clients) {
+        const removed = removeSameUrlDuplicatesForClient(client, serverName, plan.mcpUrl, baseDir, scope);
+        allRemovedNames.push(...removed);
     }
-    options.log?.(`Registered ${mcpServerNames(manifest, options.serverName).join(", ")} for ${clients.join(", ")} at ${plan.mcpUrl}`);
+    const uniqueRemoved = [...new Set(allRemovedNames)];
+    const logMsg = uniqueRemoved.length > 0
+        ? `Registered "${serverName}" for ${clients.join(", ")} at ${plan.mcpUrl}; removed duplicate entries: ${uniqueRemoved.join(", ")}`
+        : `Registered "${serverName}" for ${clients.join(", ")} at ${plan.mcpUrl}`;
+    options.log?.(logMsg);
     return result;
 }
 async function confirmMcpRegistration(result, displayName, scope) {